PROMPTS 



Prompts are uppercase letters, followed by a colon (:), telling you 
what you can do next in a command. Slash (/) separates choices. 
Square brackets [ ] enclose options you can ask for by typing 
<OPT>. The letters and what they stand for are listed below. (See 
SPECIAL CHARACTERS or SPECIAL TERMS for definitions.) 

OPT <OPT> 

RC <RC> 

T TYPEIN 

V VIEWSPECS 

Y/N y or <OK> for yes; n for no 



A ADDRESS 

C Command word 

L LEVADJ 

M <MARK> 

OK <OK> 



SPECIAL CHARACTERS 

Parentheses enclose equivalent control character or mouse button 
combination. • = button pressed, o = button not pressed. 

<BC> BACKSPACE CHARACTER: Erases the previous 

character or command step. (<CTRL-A> or »oo) 

<BW> BACKSPACE WORD: Erases the previous word. 

(<CTRL-W> or »»o) 

<CD> COMMAND DELETE: Cancels the current command. 

«CTRL-X> or o»o) 

<ESC> ESCAPE: Fills out file names and directory names. 

(•o.) 

<HELP> Displays information about the current command; see 
ONLINE HELP. «CTRL-Q» 

<INS> INSERT: Lets you continually insert statements until 

you type <CD>; see WRITING. «CTRL-E» 

<LIT> LITERAL: Used in TYPEIN to precede a character that 

otherwise would have a special effect (such as ? at a 
prompt). (<CTRL-V» 

<MARK> The process of pointing to a particular character on the 
screen and typing <OK>. 

<NULL> Specifies "nothing" when typed for CONTENT. 
(<CTRL-N» 

<OK> Terminates part or all of an AUGMENT command. At 

the end of a command, you may type <INS> or <RC> 
in place of <OK>. «CTRL-D> or oo») 

<OPT> OPTION: Asks for an option in a command. 

«CTRL-U» 

<RC> REPEAT COMMAND: Repeats the last command 

continually until you type <CD>. Also used to repeat 
the text from a previous content or word search. 
(<CTRL-B> or o»«) 

<RET> RETURN: Terminates part or all of an Executive 

command; forces a new line in AUGMENT TYPEIN. 
«CTRL-M>) 

<TAB> Repeats a previous character, word, or content search. 

Also used for tabulation in TYPEIN. «CTRL-I» 

<SP> SPACE: Typed by pressing the space bar. 



AUGMENT QUICK REFERENCE 



HOW TO READ THIS CARD 

This card lists the commands and features most commonly used in 
display mode. (For others, use Help; see ONLINE HELP.) All 
commands are Base subsystem commands unless noted otherwise. 

color Blue indicates what you enter. Black boldface 

indicates what the system displays. 

UPPERCASE Uppercase words represent choices. The most 

common choices are listed below the command or 
under SPECIAL TERMS. For others, type ? at the 
prompt. 



Initial 
Uppercase 



< > 



<CTRL- > 



[ ] 



Words in blue with the first letter capitalized are 
command words; type the first letter of the word or 
type a space and then the first letter or letters. 
AUGMENT fills out the word. 

denote special characters you type (see SPECIAL 
CHARACTERS) 

surrounding a character indicates a control character; 
hold down the CTRL key while typing that character 

separates choices 

enclose options you ask for by typing <OPT> 



STARTING A WORK SESSION 



Use the NAMEs, PASSWORDS, and NUMBER you are given. 

Connecting to the host computer through TYMNET: 

please type your terminal identifier a 
please log in: NAME;PASSWORD<RET> 

Connecting to the host computer through ARPANET: 

@i<SP>25<RET> 
<CTRL-Y>o<SP>NUMBER<RET> 

Logging into the host computer and entering AUGMENT: 

@log<SP>NAME<SP>PASSWORD<SPXRET> 
@augment<RET> 



ENDING A WORK SESSION 

Logout Job OK/TYPEIN from the Base subsystem 

After logging out, ARPANET users close the connection with 
<CTRL-Y>c<RET>. 



ONLINE HELP 

@tutor<RET> instead of entering AUGMENT; teaches you how to 
use basic AUGMENT capabilities 

The following are available in all AUGMENT subsystems. 

? at any prompt, lists your current alternatives 

<HELP> at any prompt, displays information about the 

command as far as you have given it 

Help OK displays information about the current subsystem 

Help TYPEIN displays information about the term or command 
you give for TYPEIN 

After typing <HELP> or starting a Help command, your choices are: 
TYPEIN another term or command or a menu item number 
< to go back to a previous Help view 

<CD> to return to your work in progress 

Jump (to) Locator OK a guide to AUGMENT documentation 

WRITING 

Create File (to be named) CONTENT 

Insert Statement (to follow statement at) LOCATION 
TYPEIN/ [ADDRESS] 

Insert Statement (to follow statement at) LOCATION LEVADJ 
CONTENT 

<INS> INSERTSPEC INSERTSPEC ... <CD> 

INSERTSPEC = TYPEIN or [ADDRESS] or LEVADJ CONTENT 

READING AND CHANGING VIEWS 

The Jump commands are available in all subsystems. 

Jump (to) <MARK> VIEWSPECS 

Jump (to) Link CONTENT 

Jump (to) Origin (of file) LOCATION VIEWSPECS 

Jump (to) Next/Back/Down/Up (from) LOCATION VIEWSPECS 

Jump (to) Successor/Predecessor (of) LOCATION VIEWSPECS 

Jump (to) Head/Tail (of plex at) LOCATION VIEWSPECS 

Jump (to) End (of) File/Branch/Plex (at) LOCATION VIEWSPECS 

Jump (to) Content/Word First/Next <RO/CONTENT VIEWSPECS 

<TAB> command repeats a previous word or content search. 

Jump (to) Name First/Next/Any CONTENT VIEWSPECS 

Set Name (delimiters in) STRUCTURE (left delimiter to be) 
CONTENT (right delimiter to be) CONTENT 

Reset Name (delimiters to) STRUCTURE OK 

Show Name (delimiters for statement at) LOCATION 

Jump (to) Return OK 

Jump (to) Return File OK 



Set Viewspecs VIEWSPECS 

With a mouse, you can set lowercase viewspecs by pressing the left 
and middle mouse buttons while typing the viewspecs, and uppercase 
viewspecs by pressing all mouse buttons while typing the viewspecs 
(in lowercase). Include viewspec f or F. 

Reset Viewspecs (to defaults) OK 



EDITING 

Insert Front (of statement at) LOCATION (the text) CONTENT 

Insert STRING (to follow STRING at) LOCATION CONTENT 

Insert STRUCTURE (to follow statement at) LOCATION 
TYPEIN/ [ADDRESS] 

Insert STRUCTURE (to follow statement at) LOCATION LEVADJ 
CONTENT 

Delete STRING (at) LOCATION 

Delete [(Altered) FVIEWSPECS] STRUCTURE (at) LOCATION 
(really?) OK 

Move STRING (from) LOCATION/ [TYPEIN] (to follow STRING 
at) LOCATION 

Move [(filtered) FVIEWSPECS] STRUCTURE (from) LOCATION/ 
[TYPEIN] (to follow statement at) LOCATION LEVADJ 

Copy STRING (from) LOCATION/ [TYPEIN] (to follow STRING 
at) LOCATION 

Copy [(filtered) FVIEWSPECS] STRUCTURE (from) LOCATION/ 
[TYPEIN] (to foUow statement at) LOCATION LEVADJ 

Replace STRING /STRUCTURE (at) LOCATION (by) CONTENT 

Replace All (occurrences to) [(filtered) FVIEWSPECS] 
STRUCTURE (at) LOCATION (of old) STRING CONTENT (by new 
STRING) CONTENT OK/ALSO 

ALSO = Also (of old STRING) STRING (by new STRING) 

CONTENT OK/ALSO 

Transpose STRING/STRUCTURE (at) LOCATION (and) LOCATION 

Force (case of) STRING/STRUCTURE (at) LOCATION CASEMODE 
OK 

Force (case of) [CASEMODE (for)] STRING/STRUCTURE (at) 
LOCATION 

CASEMODE = Lower or Upper or First (letter upper) 

Append Statement (at) LOCATION/ [TYPEIN] (to) LOCATION (join 
with) OK/TYPEIN/ [LOCATION] 

Append All (statements to) [(filtered) FVIEWSPECS] STRUCTURE 
(at) LOCATION (join with) OK/TYPEIN/ [LOCATION] 

Break Statement (after visible at) LOCATION LEVADJ 

Reverse Group/Plex (at) LOCATION 

Sort Branch/Group/Plex (at) LOCATION OK for alphabetic sort 

Sort Branch/Group/Plex (at) LOCATION SORTTYPE 

SORTTYPE = Date (and time) OK/SORTTYPE 
or Reverse OK/SORTTYPE 



SPECIAL DISPLAY FEATURES 



FILE HANDLING 



Break Window Horizontally /Vertically (at) <MARK> OK 

Break Window Horizontally /Vertically (at) Center (of window) 
<MARK> OK 

Commands affect the window containing the cursor at the final 
<OK>. To offset indenting in a narrow window, set viewspecs 1Q. 

Enlarge Window <MARK> (to) <MARK> OK 

Delete Window <MARK> (enlarging window at) <MARK> OK 

Freeze [(filtered) FVIEWSPECS] STRUCTURE (at) LOCATION 
(with viewspecs) VIEWSPECS 

Include o in VIEWSPECS or set viewspec o afterwards. 

Thaw All (frozen statements) OK 

Thaw STRUCTURE (at) LOCATION 

The following are available on the AUGMENT 1200 terminal. 

SCREEN SAVE key saves current screen image; SCREEN SWITCH 
key displays image saved with SCREEN SAVE key. 

To double the width of the file window: 

@widescreen<RET> at the Executive @ 

Then push in switch 4 on display's front panel, press LOCAL 
RESET key, and enter AUGMENT. Move cursor to edge of screen 
to display beyond edge. To return to normal width, Quit from 
AUGMENT, push out switch 4, press LOCAL RESET, and reenter 
AUGMENT. Useroption for display right margin must be set to 
160. For details, Jump (to) Locator to find documentation. 

PRINTING 

Print [(printing view) VIEWSPECS] FSTRUCTURE (on device) 
OK/DEVICETYPE (specifications:) OK/DEVICESPECS 

Print Sequential (file named) CONTENT (on device) 
OK/DEVICETYPE (specifications:) OK/DEVICESPECS 

Set Print (default device for session to) DEVICETYPE OK 

DEVICETYPE = Workstation (printer) 

or Lineprinter not for Print Sequential 
or Terminal not for Print Sequential 

DEVICESPECS = 
Copies CONTENT OK/DEVICESPECS not for Terminal 
or Wait (at page break) OK/DEVICESPECS not for Lineprinter 
or Quickformat OK/DEVICESPECS not for Print Sequential 

If Quickformat is not requested, output is formatted through the 
Output Processor. 

Start Workstation (printer) OK 

Stop Workstation (printer) WHEN (use START command to 
resume printing) OK 

WHEN = Immediately or End (of) File/Page 



Update (file) OK (new version) OK 

Update (file) New/Old (version) OK 

Update (file) Compact (new version) OK 

Update (file) Renamed CONTENT 

Delete File (named) CONTENT (really?) OK 

Undelete File (named) CONTENT 

Delete Modifications (to file) FILESPEC (really?) OK 

Undelete Modifications (to file) FILESPEC (really?) OK 

Check File (structure for internal consistency for file) FILESPEC 

Show Status (for file) FILESPEC 

FILESPEC = OK or TYPEIN or [LOCATION] 
Move File (named) CONTENT (to a file named) CONTENT 
Rename (file named) CONTENT (to be named) CONTENT 

Copy File (named) CONTENT (to a new file to be named) 

CONTENT 

Create Augment (structure from sequential file named) CONTENT 
(to follow statement at) LOCATION LEVADJ (using) SEQTYPE OK 

SEQTYPE = One/Two «RET>s to end statement) 

or Two (<RET>8 to end statement) Justified (delete 
extra <SP» 

Create Sequential SEQFILE (from) FSTRUCTURE [(force upper 
case)] VIEWSPECS 

SEQFILE = File (named) CONTENT 

or Appending (to file named) CONTENT 



DIRECTORY HANDLING 

Connect (to) Directory (named) TYPEIN/ [LOCATION] (password) 
TYPEIN/ [ADDRESS] /OK 

Connect (to) Directory (named) OK (login directory) OK 

Trim (files in) Directory (named) DIRSPEC (to keep number of 
versions) CONTENT 

Expunge (deleted files in) Directory (named) DIRSPEC 

Show Disk (space for) Directory (named) DIRSPEC 

Show Directory (named) DIRSPEC OK/DIRTYPE 

Copy Directory (named) DIRSPEC (to follow statement at) 
LOCATION LEVADJ OK/DIRTYPE 

DIRSPEC ■ OK (connected directory) or TYPEIN 
or [LOCATION] 

DIRTYPE = No Version (numbers) OK/DIRTYPE 
or Size (in pages) OK/DIRTYPE 
or Date (of) Creation /Read /Write OK/DIRTYPE 
or Last (writer) OK/DIRTYPE 
or Deleted (files only) OK/DIRTYPE 
or Everything OK/DIRTYPE 
or For (file) CONTENT OK/DIRTYPE 



SPECIAL TERMS 



CONTENT FILTERING 



ADDRESS Type an address, ending with <OK>. (See LINKS 

AND ADDRESSES.) 

CONTENT <MARK>/TYPEIN/ [ADDRESS] . If at the end of a 

command, <MARK> must be followed by <OK>. 
For Text, Phrase, or Group, two <MARK>s or 
ADDRESSes are needed. 

FSTRUCTURE STRUCTURE (at) LOCATION or Rest (of file) or 
File (named) CONTENT 

FVIEWSPECS Type level clipping or content filtering viewspec 

characters, ending with <OK>. (See VIEWSPECS.) 

LEVADJ Type level-adjustment characters (u for up, d for 

down), ending with <OK> or <SP>, or type <OK> 
or <SP> for same level. 

LOCATION <MARK>/ ADDRESS. If at the end of a command, 

<MARK> must be followed by <OK>. For Text, 
Phrase, or Group, two <MARK>s or ADDRESSes 
are needed. 

OK Type <OK>. 

STRING Character/ Word/ Text/ Phrase/ Visible/ Invisible/ 

Number/ Link/ Directive 

STRUCTURE Statement/Branch/Group/Plex 

TYPEIN Type a series of characters, ending with <OK>. 

Context may require special TYPEIN, such as a link 
or a file name. 

VIEWSPECS Type viewspec characters, ending with <OK>, or 
just <OK> for no change. (See VIEWSPECS.) 



IN CASE OF TROUBLE 

If what you see on your screen looks wrong, do a local reset (press 
LOCAL RESET key or whatever is appropriate for your terminal) so 
terminal will redisplay or set viewspec F so AUGMENT will 
redisplay. 

If nothing seems to be happening, type <CTRL-T>; if you get no 
response, reconnect to the host computer and do @where 
NAME<RET>. If Where lists your job, attach to it. (See the lesson 
"Starting and Ending an AUGMENT Work Session".) 

If you make a serious mistake while editing, you can copy from the 
previous version of the file or use Delete Modifications. 

If you can't modify a file because it is already being modified by 
you, Quit and do ©where NAME<RET>. If Where lists two jobs, do 
@>logout<RET> and attach to the other job; otherwise, try 
@pop<RET> to get back to an earlier AUGMENT session. 

If you can't update a file you modified in another directory, try 
connecting to the directory and then updating. 

If a message from Check File or any other command reports "Bad 
Hie", ask Help about the term "bad". (See ONLINE HELP.) 

For other assistance, contact your AUGMENT representative. 



Set Content (pattern to be) CONTENT 

To display filtered statements, set viewspec i or k. To edit or 
freeze filtered statements, use i in the [(filtered) FVIEWSPECS] 
option of the editing or Freeze command. 

Show Content (pattern currently in force) OK 



UTILITY COMMANDS 

Process (commands from) STRUCTURE (at) LOCATION 

Show Changes (to system) OK 

Show Version (of current AUGMENT system) OK 

MOVING AROUND BETWEEN SUBSYSTEMS 

These commands are available in all subsystems. 

Goto (subsystem) SUBSYSTEM/ [(subsystem name) CONTENT] OK 

Execute (command in) SUBSYSTEM/ [(subsystem name) 

CONTENT] 

SUBSYSTEM = Programs or Exec or Base 

or a previously loaded subsystem 

Quit OK 

CREATING AND EDITING TABLES 

The following are Table subsystem commands. Use Help in Table 
for additional commands and information. (See ONLINE HELP.) 

Insert Header (below) LOCATION (with number of columns) 
CONTENT (of widths) CONTENT 

Insert Row (after) LOCATION (with) CONTENT (justified) 
OK/ JUST 

Separate entries with semicolon ( ; ) or <TAB>. 

Insert Blank Column (to follow) LOCATION (with width) 
CONTENT 

Insert Blank Group (of rows after) LOCATION (number of rows) 

CONTENT 

Replace Entry/ Row/ Column (at) LOCATION (by) CONTENT 
(justified) OK/JUST 

Justify Entry/Row/Column (at) LOCATION (justified) OK/JUST 

JUST = Left OK or Right OK or Center OK 
or Two (places to right) OK 

Total Row/ Column (of numbers at) LOCATION (enter result as) 
RESULT 

RESULT = Entry (at) LOCATION or Status OK 

or Visible (after visible at) LOCATION 

Fillout Row/Table (at) LOCATION 



LINKS AND ADDRESSES 

A "link" is <ADDRESS:VIEWSPECS> 

You may omit the angle brackets < > when you type a link in a 
command. Parentheses ( ) as well as angle brackets can delimit a 
link. 

ADDRESS = FILEADDRESS for origin statement of file 

or INFILEADDRESS for location in current file 
or FILEADDRESS INFILEADDRESS 
or omit entirely for current location 

FILEADDRESS = FILENAME, at current site and directory 
or DIRECTORY.FILENAME, at current site 
or SITE,DIRECTORY,FILENAME, 

Note that every form of FILEADDRESS ends with a comma. 

FILENAME = NAME 

or NAME.EXTENSION 

or NAME.EXTENSION;VERSION 

<ESC> fills out file names and directory names. 

INFILEADDRESS is one or more of the elements below, separated by 
<SP>. <SP> is not required if the next element begins with 
punctuation. Use Help to get information about any of these 
elements (by typing its name) or about other elements {by typing 
"INFILEADDRESS"). (See ONLINE HELP.) 

Element Nam* Example 

STATEMENTNUMBER la2b 



Blank lines 

Statement numbers 
and SIDs 



Statement names 

Statement signatures 

Level and line 
clipping 



SID 

STATEMENTNAME 

NEXTNAME 

BRANCHNAME 

CHARACTERSEARCH 

CONTENTSEARCH 

WORDSEARCH 

POSITION 



012 



statementname 



* statementname 



Istatementname 



STRINGPOSITION 



"text" 

"word"=w 

.n next statement 

.u statement up a level 

.e end of branch 

.t tail of plex 

.2b two statements back 

,ds successor of statement down a level 

.1 location pointed to by embedded link 

.r return to previous location in file 

.rf return to previous file 

+e last character of statement 



Structure clipping 
Content filtering 
Level indenting 

Frozen statements 
Screen recreation 



VIEWSPECS 

Blank lines between statements on y 

Blank lines between statements off z 

Statement numbers/SIDs on m 

Statement numbers/SIDs off n 

Statement numbers/SIDs right G 

Statement numbers/SIDs left H 

Show SIDs, not statement numbers I 

Show statement numbers, not SIDs J 

Show statement names C 

Don't show statement names D 

Show statement signatures K 

Don't show statement signatures L 

Show first level only d 

Show one level more b 

Show one level less a 

Show all levels c 
Show levels down to level of statement to e 
be at top of file window 

Show first lines only t 

Show one line more r 

Show one line less q 

Show all lines s 

Show one level and one line only x 

Show all levels and all lines w 

Show branch only g 

Show all branches h 

Show plex only 1 

Filter statements i 

Don't filter statements j 

Show next filtered statement k 

Level indenting on A 

Level indenting off B 
With viewspec 1 or g, offsets indenting to Q 
level of statement at top of file window; 
turn off with viewspec h 

Show frozen statements o 

Don't show frozen statements p 

Put viewspecs into effect f 
Recreate display (with viewspecs in effect) F 

Recreate window after each change u 

Defer recreating window v 
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